这段代码定义了一个名为 `CFX_CTTGSUBTable` 的类，它用于解析和处理 TrueType 或 OpenType 字体中的 GSUB（Glyph Substitution）表。GSUB 表是字体文件中的一部分，用于定义在文本渲染过程中如何替换字形以实现特定的排版效果，如连写、替代字形或垂直排版。

以下是该类的主要功能和组成部分的解释：

1. * *构造函数和析构函数 * *:
-`explicit CFX_CTTGSUBTable(pdfium::span<const uint8_t> gsub);`：构造函数接收一个包含 GSUB 表数据的 span，并初始化 `CFX_CTTGSUBTable` 对象。
- `~CFX_CTTGSUBTable();`：析构函数，确保正确清理分配的资源。

2. * *公共成员函数 * *:
-`uint32_t GetVerticalGlyph(uint32_t glyphnum) const;`：根据给定的字形编号 `glyphnum` 获取其对应的垂直排版字形编号。如果找不到，则返回原始字形编号。

3. * *私有成员结构 * *:
-`FeatureRecord`：表示 GSUB 表中的特征记录，包括特征标签（feature tag）和查找列表索引（lookup list indices）。
- `RangeRecord`：用于格式 2 的覆盖表，定义了字形范围及其对应的起始覆盖索引。
- `CoverageFormat`：使用 `absl::variant` 来表示不同格式的覆盖表，可以是简单的字形数组（格式 1）或范围记录（格式 2）。
- `SubTable`：表示子表，包含覆盖表和表格数据（如 DeltaGlyphID 或替代字形列表）。
- `Lookup`：表示查找表，包含查找类型和多个子表。

4. * *私有成员函数 * *:
-`LoadGSUBTable`, `Parse`, `ParseScriptList`, `ParseScript`, `ParseLangSys`, `ParseFeatureList`, `ParseFeatureLookupListIndices`, `ParseLookupList`, `ParseLookup`, `ParseCoverage`, `ParseSingleSubst`：这些函数用于从二进制数据中解析 GSUB 表的不同部分。
- `GetVerticalGlyphSub`, `GetVerticalGlyphSub2`：用于获取垂直排版字形的具体实现。
- `GetCoverageIndex`：根据覆盖表和字形编号找到覆盖索引。
- `GetUInt8`, `GetInt16`, `GetUInt16`, `GetInt32`, `GetUInt32`：辅助函数，用于从二进制数据中读取不同长度的整数。

5. * *私有成员变量 * *:
-`feature_set_`：存储已解析的特征集合。
- `script_list_`：存储脚本记录列表。
- `feature_list_`：存储特征记录列表。
- `lookup_list_`：存储查找表列表。

这个类的设计允许对 GSUB 表进行详细的解析和操作，特别是为了支持垂直排版时的字形替换。通过这些功能，PDFium 库可以正确地渲染包含复杂排版规则的 PDF 文档。


// Copyright 2014 The PDFium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

// Original code copyright 2014 Foxit Software Inc. http://www.foxitsoftware.com

#ifndef CORE_FPDFAPI_FONT_CFX_CTTGSUBTABLE_H_
#define CORE_FPDFAPI_FONT_CFX_CTTGSUBTABLE_H_

#include <stdint.h>

#include <optional>
#include <set>
#include <vector>

#include "core/fxcrt/data_vector.h"
#include "core/fxcrt/span.h"
#include "third_party/abseil-cpp/absl/types/variant.h"

class CFX_CTTGSUBTable {
 public:
  explicit CFX_CTTGSUBTable(pdfium::span<const uint8_t> gsub);
  ~CFX_CTTGSUBTable();

  uint32_t GetVerticalGlyph(uint32_t glyphnum) const;

 private:
  using FeatureIndices = DataVector<uint16_t>;
  using ScriptRecord = std::vector<FeatureIndices>;

  struct FeatureRecord {
    FeatureRecord();
    ~FeatureRecord();

    uint32_t feature_tag = 0;
    DataVector<uint16_t> lookup_list_indices;
  };

  struct RangeRecord {
    RangeRecord();

    uint16_t start = 0;
    uint16_t end = 0;
    uint16_t start_coverage_index = 0;
  };

  // GlyphArray for format 1.
  // RangeRecords for format 2.
  using CoverageFormat = absl::
      variant<absl::monostate, DataVector<uint16_t>, std::vector<RangeRecord>>;

  struct SubTable {
    SubTable();
    SubTable(const SubTable& that) = delete;
    SubTable& operator=(const SubTable& that) = delete;
    SubTable(SubTable&& that) noexcept;
    SubTable& operator=(SubTable&& that) noexcept;
    ~SubTable();

    CoverageFormat coverage;
    // DeltaGlyphID for format 1.
    // Substitutes for format 2.
    absl::variant<absl::monostate, int16_t, DataVector<uint16_t>> table_data;
  };

  struct Lookup {
    using SubTables = std::vector<SubTable>;

    Lookup();
    Lookup(const Lookup& that) = delete;
    Lookup& operator=(const Lookup& that) = delete;
    Lookup(Lookup&& that) noexcept;
    Lookup& operator=(Lookup&& that) noexcept;
    ~Lookup();

    uint16_t lookup_type = 0;
    SubTables sub_tables;
  };

  bool LoadGSUBTable(pdfium::span<const uint8_t> gsub);
  void Parse(pdfium::span<const uint8_t> scriptlist,
             pdfium::span<const uint8_t> featurelist,
             pdfium::span<const uint8_t> lookuplist);
  void ParseScriptList(pdfium::span<const uint8_t> raw);
  ScriptRecord ParseScript(pdfium::span<const uint8_t> raw);
  FeatureIndices ParseLangSys(pdfium::span<const uint8_t> raw);
  void ParseFeatureList(pdfium::span<const uint8_t> raw);
  DataVector<uint16_t> ParseFeatureLookupListIndices(
      pdfium::span<const uint8_t> raw);
  void ParseLookupList(pdfium::span<const uint8_t> raw);
  Lookup ParseLookup(pdfium::span<const uint8_t> raw);
  CoverageFormat ParseCoverage(pdfium::span<const uint8_t> raw);
  SubTable ParseSingleSubst(pdfium::span<const uint8_t> raw);

  std::optional<uint32_t> GetVerticalGlyphSub(const FeatureRecord& feature,
                                              uint32_t glyphnum) const;
  std::optional<uint32_t> GetVerticalGlyphSub2(const Lookup& lookup,
                                               uint32_t glyphnum) const;
  int GetCoverageIndex(const CoverageFormat& coverage, uint32_t g) const;

  uint8_t GetUInt8(pdfium::span<const uint8_t>& p) const;
  int16_t GetInt16(pdfium::span<const uint8_t>& p) const;
  uint16_t GetUInt16(pdfium::span<const uint8_t>& p) const;
  int32_t GetInt32(pdfium::span<const uint8_t>& p) const;
  uint32_t GetUInt32(pdfium::span<const uint8_t>& p) const;

  std::set<uint32_t> feature_set_;
  std::vector<ScriptRecord> script_list_;
  std::vector<FeatureRecord> feature_list_;
  std::vector<Lookup> lookup_list_;
};

#endif  // CORE_FPDFAPI_FONT_CFX_CTTGSUBTABLE_H_
